import { get, post, postWithQueryParams } from "@/api/request";

/**
 * 项目进度汇报 / 项目进度汇报添加
 * @param {object} data
 * @param {array<number>} [data.attachList] 附件ID列表
 * @param {number} [data.completionProgress] 完成进度
 * @param {string} [data.createTime] 创建时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.createUser] 创建用户
 * @param {number} [data.delFlag] 是否已删除(0否；1是)
 * @param {number} [data.id] 主键
 * @param {string} [data.lastReportingTime] 最后一次上报时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.overallPlannedEndTime] 总计划结束时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.planName] 计划名称
 * @param {number} [data.projectId] 项目ID
 * @param {string} [data.responsiblePerson] 负责人
 * @param {string} [data.totalPlannedStartTime] 总计划开始时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.updateTime] 更新时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.updateUser] 更新用户
 * @param {string} [data.versionNumber] 版本号
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<ProjectProgressReport页面展示实体>}
 */
export function projectProgressReportAdd(data, config) {
  return post("/projectProgressReport/add", data, config);
}

/**
 * 项目进度汇报 / 项目进度汇报删除
 * @param {object} params
 * @param {object} data
 * @param {string} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<ProjectProgressReport页面展示实体>}
 */
export function projectProgressReportDelete(params, data, config) {
  return postWithQueryParams("/projectProgressReport/delete", params, data, config);
}

/**
 * 项目进度汇报 / 项目进度汇报查询详情
 * @param {object} params
 * @param {string} params.id ID
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<ProjectProgressReport页面展示实体>}
 */
export function projectProgressReportDetail(params, config) {
  return get("/projectProgressReport/detail", params, config);
}

/**
 * 项目进度汇报 / 项目进度汇报根据项目进度id查询列表
 * @param {object} data
 * @param {number} [data.id] 主键
 * @param {number} [data.length] 分页大小
 * @param {number} [data.orderAsc] 排序方向
 * @param {string} [data.orderColum] 排序字段
 * @param {number} [data.pageIndex] 分页下标
 * @param {string} [data.projectName] 项目名称
 * @param {number} [data.start] 查询记录起始下标
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<分页返回实体<ProgressReport页面展示实体>>}
 */
export function projectProgressReportGetProgressById(data, config) {
  return post("/projectProgressReport/getProgressById", data, config);
}

/**
 * 项目进度汇报 / 项目进度汇报分页查询
 * @param {object} data
 * @param {number} [data.completionProgress] 完成进度
 * @param {string} [data.createTime] 创建时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.createUser] 创建用户
 * @param {number} [data.delFlag] 是否已删除(0否；1是)
 * @param {number} [data.id] 主键
 * @param {string} [data.lastReportingTime] 最后一次上报时间 YYYY-MM-DD HH:mm:ss
 * @param {number} [data.length] 分页大小
 * @param {number} [data.orderAsc] 排序方向
 * @param {string} [data.orderColum] 排序字段
 * @param {string} [data.overallPlannedEndTime] 总计划结束时间 YYYY-MM-DD HH:mm:ss
 * @param {number} [data.pageIndex] 分页下标
 * @param {string} [data.planName] 计划名称
 * @param {number} [data.projectId] 项目ID
 * @param {string} [data.projectName] 项目名称
 * @param {string} [data.responsiblePerson] 负责人
 * @param {number} [data.start] 查询记录起始下标
 * @param {string} [data.totalPlannedStartTime] 总计划开始时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.updateTime] 更新时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.updateUser] 更新用户
 * @param {string} [data.versionNumber] 版本号
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<分页返回实体<ProjectProgressReport页面展示实体>>}
 */
export function projectProgressReportList(data, config) {
  return post("/projectProgressReport/list", data, config);
}

/**
 * 项目进度汇报 / 项目进度汇报更新
 * @param {object} data
 * @param {array<number>} [data.attachList] 附件ID列表
 * @param {number} [data.completionProgress] 完成进度
 * @param {number} [data.id] 主键
 * @param {string} [data.lastReportingTime] 最后一次上报时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.overallPlannedEndTime] 总计划结束时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.planName] 计划名称
 * @param {number} [data.projectId] 项目ID
 * @param {string} [data.responsiblePerson] 负责人
 * @param {string} [data.totalPlannedStartTime] 总计划开始时间 YYYY-MM-DD HH:mm:ss
 * @param {string} [data.versionNumber] 版本号
 * @param {import("axios").AxiosRequestConfig} [config]
 * @returns {Promise<ProjectProgressReport页面展示实体>}
 */
export function projectProgressReportUpdate(data, config) {
  return post("/projectProgressReport/update", data, config);
}

/**
 * @template T
 * @typedef {Object} 分页返回实体
 * @property {T[]} content - 内容
 * @property {number} elementsNo
 * @property {number} limit
 * @property {number} number
 * @property {number} totalElements
 * @property {number} totalPages
 * @description 分页返回实体
 */

/**
 * @typedef {object} ProgressReport页面展示实体 页面展示实体
 * @property {string} actualCompletionTime 实际完成时间
 * @property {string} actualStartTime 实际开始时间
 * @property {number} advanceDays 提前/滞后天数
 * @property {string} causeAnalysis 原因分析
 * @property {number} completionPercentage 完成百分比
 * @property {string} createTime 创建时间
 * @property {string} createUser 创建用户
 * @property {number} id 主键
 * @property {number} isMilestoneNode 是否里程碑节点
 * @property {string} planTaskName 计划任务名称
 * @property {number} plannedConstructionPeriod 计划工期
 * @property {string} plannedEndTime 计划结束时间
 * @property {string} plannedStartTime 计划开始时间
 * @property {string} preTask 前置任务
 * @property {string} remedialMeasuresDelayedConstructionPeriod 工期滞后的补救措施
 * @property {string} reportPerson 上报人
 * @property {string} responsiblePerson 负责人
 * @property {number} thisRatio 本次上报比例
 * @property {number} totalCompletionPercentage
 * @property {string} updateTime 更新时间
 * @property {string} updateUser 更新用户
 * @description 页面展示实体
 */

/**
 * @typedef {object} ProjectProgressReport页面展示实体 页面展示实体
 * @property {boolean} canDelete 是否拥有删除权限
 * @property {boolean} canEdit 是否拥有编辑权限
 * @property {number} completionProgress 完成进度
 * @property {string} createTime 创建时间
 * @property {string} createUser 创建用户
 * @property {string} createUserDeptName 创建用户所属部门
 * @property {string} createUserRealName 创建用户真实姓名
 * @property {number} delFlag 是否已删除(0否；1是)
 * @property {number} id 主键
 * @property {string} lastReportingTime 最后一次上报时间
 * @property {string} overallPlannedEndTime 总计划结束时间
 * @property {string} planName 计划名称
 * @property {number} projectId 项目ID
 * @property {string} projectName 项目名称
 * @property {string} responsiblePerson 负责人
 * @property {string} totalPlannedStartTime 总计划开始时间
 * @property {string} updateTime 更新时间
 * @property {string} updateUser 更新用户
 * @property {string} versionNumber 版本号
 * @description 页面展示实体
 */
